Skip to content

Comments

Improve sub-agent output clarity in migration documentation#211

Merged
nhorton merged 2 commits intomainfrom
claude/concise-repair-subagents-6u4pe
Feb 15, 2026
Merged

Improve sub-agent output clarity in migration documentation#211
nhorton merged 2 commits intomainfrom
claude/concise-repair-subagents-6u4pe

Conversation

@nhorton
Copy link
Contributor

@nhorton nhorton commented Feb 15, 2026

Summary

Updated migration documentation to enforce concise, minimal output from sub-agents during job cleanup and repair operations. This reduces noise and makes it easier to identify what actually changed.

Key Changes

  • errata.md: Added guidance for the legacy skill folder removal sub-agent to output minimal text, reporting only what was removed or confirming nothing was found, without narrating the process or echoing commands
  • fix_jobs.md:
    • Added a concise output instruction at the beginning of the sub-agent prompt
    • Updated the final reporting requirement to specify which checks passed with no changes and which changes were made (one line each), rather than generic "report what changes were made"

Implementation Details

These changes improve the clarity of sub-agent instructions by:

  1. Explicitly requesting minimal, actionable output instead of verbose process narration
  2. Preventing unnecessary echoing of commands or file contents
  3. Standardizing the reporting format to be scannable and concise
  4. Making it easier for users to quickly identify what migrations were performed

The changes apply to both the errata cleanup step and the job.yml repair step in the migration workflow.

https://claude.ai/code/session_017B8xtZAgmif6v86MbXXjwb

The parallel sub-agents in fix_jobs and errata steps were producing
verbose output. Updated their prompts to request concise reporting:
only changes made or confirmation of no changes needed.

https://claude.ai/code/session_017B8xtZAgmif6v86MbXXjwb
Instead of spawning one sub-agent per job, use a single sub-agent
that iterates over all jobs and removes their legacy skill folders.

https://claude.ai/code/session_017B8xtZAgmif6v86MbXXjwb
@nhorton nhorton added this pull request to the merge queue Feb 15, 2026
Merged via the queue into main with commit e74c1b8 Feb 15, 2026
4 checks passed
@nhorton nhorton deleted the claude/concise-repair-subagents-6u4pe branch February 15, 2026 21:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants